User @rainbow-promise, please sign the CLA here.

My initial intention with #6392 was to make frame-omni-bencher look more like chain-spec-builder in terms of docs and ensuring the commands examples are backed by tests (not necessarily asserting on what they produce, but how they look like - flags, arguments etc). I haven't thought initially to add frame-omni-bencher material to the reference_docs, and there seems to be a page describing things at a high-level: https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_benchmarking_weight/index.html.

Better to focus on the frame-omni-bencher README.md level docs for the scope of this PR.

Hey @rainbow-promise ! How it is going?

I am wondering if you'd like to continue the work here, or take a break. I would be happy to continue looking over this if you can contribute.

Would like to continue @iulianbarbu, who knew docs would be this complex 🙃.